Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add an extension for UEFI references (not DTSPEC anymore) #109

Merged
merged 1 commit into from
Feb 27, 2024

Conversation

vstehle
Copy link
Collaborator

@vstehle vstehle commented Sep 8, 2023

Here is an extension to help with our numerous references to the UEFI specification.
I converted all the UEFI references to use the new extension and adapted a bit for readability when necessary.
Let me know how you like the result.

Update: added Devicetree references, too.

@vstehle vstehle changed the title Add an extension for UEFI references Add an extension for UEFI (and now DTSPEC) references Sep 12, 2023
@vstehle
Copy link
Collaborator Author

vstehle commented Sep 12, 2023

Fixed typo breaking all the links.

@vstehle vstehle force-pushed the uefi-links branch 3 times, most recently from 110da55 to 17e201a Compare September 27, 2023 14:46
@vstehle
Copy link
Collaborator Author

vstehle commented Sep 27, 2023

Rebased, added python typing and added more details to the README.

@vstehle
Copy link
Collaborator Author

vstehle commented Sep 28, 2023

Fixed index line endings.

@vstehle vstehle force-pushed the uefi-links branch 2 times, most recently from 6470d99 to b9d82b5 Compare January 10, 2024 12:48
@vstehle vstehle force-pushed the uefi-links branch 2 times, most recently from 80b9483 to 90ad45e Compare February 13, 2024 14:29
@vstehle
Copy link
Collaborator Author

vstehle commented Feb 13, 2024

Reviving this pull request a bit:

  • Separate the html parser from the extension into a different python script.
  • Removed the Devicetree references for now, as we have no more stable URLs to link to since v0.4, only the latest version.
  • Lint the python scripts; rename to more pythonic names with _.

@vstehle vstehle changed the title Add an extension for UEFI (and now DTSPEC) references Add an extension for UEFI references (not DTSPEC anymore) Feb 21, 2024
@vstehle vstehle force-pushed the uefi-links branch 2 times, most recently from df183dc to 68e98bc Compare February 22, 2024 11:09
README.rst Outdated Show resolved Hide resolved
README.rst Show resolved Hide resolved
Add an extension python script to supplement our references to the UEFI
specification with corresponding section title and web-page hyperlink.

Hook the new extension into the `conf.py' sphinx configuration.

We keep the index under version control for caching, and we have a python
script to re-generate it.

Convert all the UEFI references to use the new extension and adapt a bit
for readability when necessary.

Mention the extension in the README.

While at it, tell git to ignore the folders produced by python when running
the extension.

Signed-off-by: Vincent Stehlé <[email protected]>
@vstehle vstehle merged commit 0fbf1a8 into ARM-software:main Feb 27, 2024
1 check passed
@vstehle vstehle deleted the uefi-links branch February 27, 2024 18:26
@vstehle
Copy link
Collaborator Author

vstehle commented Feb 27, 2024

Thanks @xypron for reviewing this.
Merged after EBBR call of 26 Feb.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants